
<!DOCTYPE html>

<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

    <title>Device Capabilities Support &#8212; LAVA 2024.05 documentation</title>
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="_static/bootstrap-sphinx.css" />
    <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
    <script src="_static/jquery.js"></script>
    <script src="_static/underscore.js"></script>
    <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
    <script src="_static/doctools.js"></script>
    <script src="_static/sphinx_highlight.js"></script>
    <link rel="shortcut icon" href="_static/favicon.ico"/>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
    <link rel="next" title="Hidden device types" href="hiddentypes.html" />
    <link rel="prev" title="Device types" href="devicetypes.html" />
    <link rel="canonical" href="https://docs.lavasoftware.org/lava/device-capabilities.html" />
  
<meta charset='utf-8'>
<meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
<meta name="apple-mobile-web-app-capable" content="yes">
<script type="text/javascript" src="_static/js/jquery-1.12.4.min.js"></script>
<script type="text/javascript" src="_static/js/jquery-fix.js"></script>
<script type="text/javascript" src="_static/bootstrap-3.4.1/js/bootstrap.min.js"></script>
<script type="text/javascript" src="_static/bootstrap-sphinx.js"></script>


  </head><body>

  <div id="navbar" class="navbar navbar-default navbar-fixed-top">
    <div class="container">
      <div class="navbar-header">
        <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
        <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
        </button>
        <a class="navbar-brand" href="index.html"><span><img src="_static/lava.png"></span>
          LAVA</a>
        <span class="navbar-text navbar-version pull-left"><b>2024.05</b></span>
      </div>

        <div class="collapse navbar-collapse nav-collapse">
          <ul class="nav navbar-nav">
            
                <li><a href="genindex.html">Index</a></li>
                <li><a href="contents.html">Contents</a></li>
            
            
              <li class="dropdown globaltoc-container">
  <a role="button"
     id="dLabelGlobalToc"
     data-toggle="dropdown"
     data-target="#"
     href="index.html">Site <b class="caret"></b></a>
  <ul class="dropdown-menu globaltoc"
      role="menu"
      aria-labelledby="dLabelGlobalToc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="index.html">Introduction to LAVA</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="contents.html">Contents</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary of terms</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="support.html">Getting support</a></li>
</ul>
</ul>
</li>
              
                <li class="dropdown">
  <a role="button"
     id="dLabelLocalToc"
     data-toggle="dropdown"
     data-target="#"
     href="#">Page <b class="caret"></b></a>
  <ul class="dropdown-menu localtoc"
      role="menu"
      aria-labelledby="dLabelLocalToc"><ul>
<li><a class="reference internal" href="#">Device Capabilities Support</a><ul>
<li><a class="reference internal" href="#device-owner-abilities">Device owner abilities</a></li>
</ul>
</li>
</ul>
</ul>
</li>
              
            
            
              
                
  <li>
    <a href="devicetypes.html" title="Previous Chapter: Device types"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">&laquo; Device types</span>
    </a>
  </li>
  <li>
    <a href="hiddentypes.html" title="Next Chapter: Hidden device types"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Hidden device types &raquo;</span>
    </a>
  </li>
              
            
            
            
            
              <li class="hidden-sm"></li>
            
          </ul>

          
            
<form class="navbar-form navbar-right" action="search.html" method="get">
 <div class="form-group">
  <input type="text" name="q" class="form-control" placeholder="Search" />
 </div>
  <input type="hidden" name="check_keywords" value="yes" />
  <input type="hidden" name="area" value="default" />
</form>
          
        </div>
    </div>
  </div>

<div class="container">
  <div class="row">
    <div class="body col-md-12 content" role="main">
      
  <section id="device-capabilities-support">
<span id="device-capabilities"></span><span id="index-0"></span><h1>Device Capabilities Support<a class="headerlink" href="#device-capabilities-support" title="Permalink to this heading">¶</a></h1>
<p>Device Capabilities include ways for individual users and groups to get more
information on LAVA devices, control who can submit jobs to particular devices
and manage device transitions without needing full administrator access.</p>
<p>The user or group with physical access to the device is also stored, this is
useful when someone needs to interact with the device directly rather than
through network, serial or LAVA connections.</p>
<p>The Device Owner is a dedicated field in the admin interface which displays the
email address of the owner or the name of the group.</p>
<p>New device owners can only be created by the lab administrators. Equally,
assigning or transferring ownership of any device can only be done by the lab
administrators.</p>
<p>LAVA also identifies certain <a class="reference internal" href="lava-scheduler-device-type-help.html#device-type-information"><span class="std std-ref">Device type template</span></a> from the
<a class="reference internal" href="glossary.html#term-health-check"><span class="xref std std-term">health check</span></a> jobs run on the device.</p>
<section id="device-owner-abilities">
<span id="device-owners"></span><span id="index-1"></span><h2>Device owner abilities<a class="headerlink" href="#device-owner-abilities" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li><p>add free text comments to a <a class="reference internal" href="glossary.html#term-device-status-transition"><span class="xref std std-term">device status transition</span></a></p></li>
<li><p>initiate a <a class="reference internal" href="glossary.html#term-device-status-transition"><span class="xref std std-term">device status transition</span></a> on an owned device</p></li>
<li><p>cancel any “current” job running on the device.</p></li>
<li><p>restrict submissions to the device to just the owner for a period of time -
(when unrestricted, devices remain in the general usage pool.) MultiNode
submissions by the owner can use restricted and pool devices. Restricted
devices are not included in the count of devices available during job
submission by other users.</p></li>
<li><p>Edit device-specific timeouts for stages within dispatcher processes. This
allows the hardcoded values to be reset to general usage defaults and devices
which need exceptions to specify such exceptions individually.</p></li>
<li><p><a class="reference internal" href="lava-scheduler-device-help.html#edit-device-description"><span class="std std-ref">Edit device description</span></a> - could include particular hardware support on
this device or particular hardware constraints. Could also include details of
why the device is currently restricted, beyond the short message sometimes
added to the transition status change.</p></li>
<li><p>Change the <a class="reference internal" href="glossary.html#term-priority"><span class="xref std std-term">priority</span></a> for any submitted job which reserves an “owned”
device. Priority can <strong>only</strong> be changed once an owned device has been
reserved for the job and before the job starts running or an error will be
returned.</p></li>
<li><p>annotate individual job failures</p></li>
<li><p>skip health check this time only when putting a device online. This omission
is recorded in the state transition log for the device.</p></li>
<li><p>force a health check without needing to take the device offline and then back
online.</p></li>
</ul>
</section>
</section>


    </div>
      
  </div>
</div>
<footer class="footer">
  <div class="container">
    <p class="pull-right">
      <a href="#">Back to top</a>
      
    </p>
    <p>
        &copy; Copyright 2010-2019, Linaro Limited.<br/>
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 5.3.0.<br/>
    </p>
  </div>
</footer>
  </body>
</html>